Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRGetHotSpotType

You can use the QTVRGetHotSpotType function to get the type of a hot spot.

OSErr QTVRGetHotSpotType (
                     QTVRInstance qtvr,
                     UInt32 hotSpotID,
                     OSType *hotSpotType);
qtvr
An instance of a QuickTime VR movie.
hotSpotID
A hot spot ID.
hotSpotType
On entry, a pointer to a long integer. On exit, that long integer contains the type of the hot spot specified by the hot spot ID.
function result
A result code.

DESCRIPTION

The QTVRGetHotSpotType function gets the type of a hot spot whose ID you specify. In combination with the kQTVRGetHotSpotTypeSelector intercept selector, this allows an applcation to change a hot spot's type dynamically.

For example, an application can take an existing movie and cause VR to display the cursors for a type of hotspot different from the one the movie was originally authored with. In combination with intercepting kQTVRTriggerHotSpotSelector , this would allow an Internet plugin to override undefined or link hotspots in movies to make them appear and act as though they are URL links instead. If kQTVRTriggerHotSpotSelector is not intercepted, VR will attempt to act on the hotspot in the normal way; by storing both link and URL data in a file, the exact behavior can be determined at runtime by an application to allow linking to either another node locally or a remote URL link, depending on system configuration or other arbitrary considerations.

SEE ALSO

Use kQTVRGetHotSpotTypeSelector to set the selector for the intercept procedure.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |